<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Query and Activation</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Bonobo Activation API Reference Manual">
<link rel="up" href="api-reference.html" title="API Reference">
<link rel="prev" href="bonobo-activation-Initialization.html" title="Initialization">
<link rel="next" href="bonobo-activation-Utilities.html" title="Utilities">
<meta name="generator" content="GTK-Doc V1.15.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="bonobo-activation-Initialization.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="api-reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Bonobo Activation API Reference Manual</th>
<td><a accesskey="n" href="bonobo-activation-Utilities.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#bonobo-activation-Query-and-Activation.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#bonobo-activation-Query-and-Activation.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="bonobo-activation-Query-and-Activation"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="bonobo-activation-Query-and-Activation.top_of_page"></a>Query and Activation</span></h2>
<p>Query and Activation — Querying for components and Activating them</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="bonobo-activation-Query-and-Activation.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;bonobo-activation/bonobo-activation.h&gt;

typedef             <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ImplementationID" title="Bonobo_ImplementationID">Bonobo_ImplementationID</a>;
typedef             <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID">Bonobo_ActivationID</a>;
typedef             <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags">Bonobo_ActivationFlags</a>;
enum                <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationResultType" title="enum Bonobo_ActivationResultType">Bonobo_ActivationResultType</a>;
<a class="link" href="bonobo-activation-Utilities.html#Bonobo-ServerInfoList" title="Bonobo_ServerInfoList"><span class="returnvalue">Bonobo_ServerInfoList</span></a> * <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-query" title="bonobo_activation_query ()">bonobo_activation_query</a>         (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);
<span class="returnvalue">CORBA_Object</span>        <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-activate" title="bonobo_activation_activate ()">bonobo_activation_activate</a>          (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> *ret_aid</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);
<span class="returnvalue">CORBA_Object</span>        <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-activate-from-id" title="bonobo_activation_activate_from_id ()">bonobo_activation_activate_from_id</a>  (<em class="parameter"><code>const <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> aid</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> *ret_aid</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);
<span class="returnvalue">void</span>                (<a class="link" href="bonobo-activation-Query-and-Activation.html#BonoboActivationCallback" title="BonoboActivationCallback ()">*BonoboActivationCallback</a>)         (<em class="parameter"><code><span class="type">CORBA_Object</span> activated_object</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *error_reason</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-activate-async" title="bonobo_activation_activate_async ()">bonobo_activation_activate_async</a>    (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#BonoboActivationCallback" title="BonoboActivationCallback ()"><span class="type">BonoboActivationCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-activate-from-id-async" title="bonobo_activation_activate_from_id_async ()">bonobo_activation_activate_from_id_async</a>
                                                        (<em class="parameter"><code>const <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> aid</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#BonoboActivationCallback" title="BonoboActivationCallback ()"><span class="type">BonoboActivationCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="bonobo-activation-Query-and-Activation.html#bonobo-activation-set-activation-env-value" title="bonobo_activation_set_activation_env_value ()">bonobo_activation_set_activation_env_value</a>
                                                        (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *value</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="bonobo-activation-Query-and-Activation.description"></a><h2>Description</h2>
<p>
This section describes how you can query for components
and activate them.
</p>
<p>
Two set of functions are described: synchronous and
asynchronous ones. The asynchronous version of the functions
allow you to avoid blocking your application while the CORBA
servers are started.
</p>
</div>
<div class="refsect1">
<a name="bonobo-activation-Query-and-Activation.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="Bonobo-ImplementationID"></a><h3>Bonobo_ImplementationID</h3>
<pre class="programlisting">typedef CORBA_string Bonobo_ImplementationID;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="Bonobo-ActivationID"></a><h3>Bonobo_ActivationID</h3>
<pre class="programlisting">typedef CORBA_string Bonobo_ActivationID;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="Bonobo-ActivationFlags"></a><h3>Bonobo_ActivationFlags</h3>
<pre class="programlisting">typedef CORBA_long Bonobo_ActivationFlags;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="Bonobo-ActivationResultType"></a><h3>enum Bonobo_ActivationResultType</h3>
<pre class="programlisting">typedef enum {
  Bonobo_ACTIVATION_RESULT_OBJECT,
  Bonobo_ACTIVATION_RESULT_SHLIB,
  Bonobo_ACTIVATION_RESULT_NONE
} Bonobo_ActivationResultType;
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-query"></a><h3>bonobo_activation_query ()</h3>
<pre class="programlisting"><a class="link" href="bonobo-activation-Utilities.html#Bonobo-ServerInfoList" title="Bonobo_ServerInfoList"><span class="returnvalue">Bonobo_ServerInfoList</span></a> * bonobo_activation_query         (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);</pre>
<p>
Executes the <em class="parameter"><code>requirements</code></em> query on the bonobo-activation-server.
The result is sorted according to <em class="parameter"><code>selection_order</code></em>. 
<em class="parameter"><code>selection_order</code></em> can safely be NULL as well as <em class="parameter"><code>ev</code></em>.
The returned list has to be freed with CORBA_free.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>requirements</code></em> :</span></p></td>
<td>query string.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_order</code></em> :</span></p></td>
<td>sort criterion for returned list.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
<td>a <code class="literal">CORBA_Environment</code> structure which will contain 
     the CORBA exception status of the operation, or NULL
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the list of servers matching the requirements.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-activate"></a><h3>bonobo_activation_activate ()</h3>
<pre class="programlisting"><span class="returnvalue">CORBA_Object</span>        bonobo_activation_activate          (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> *ret_aid</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);</pre>
<p>
Activates a given object. <em class="parameter"><code>ret_aid</code></em> can be safely NULLed as well
as <em class="parameter"><code>ev</code></em> and <em class="parameter"><code>selection_order</code></em>. <em class="parameter"><code>flags</code></em> can be set to zero if you do 
not what to use.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>requirements</code></em> :</span></p></td>
<td>query string.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_order</code></em> :</span></p></td>
<td>sort criterion for returned list.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td>how to activate the object.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ret_aid</code></em> :</span></p></td>
<td>AID of the activated object.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
<td>
<code class="literal">CORBA_Environment</code> structure which will contain 
     the CORBA exception status of the operation. 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the CORBA object reference of the activated object.
              This value can be CORBA_OBJECT_NIL: you are supposed 
              to check <em class="parameter"><code>ev</code></em> for success.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-activate-from-id"></a><h3>bonobo_activation_activate_from_id ()</h3>
<pre class="programlisting"><span class="returnvalue">CORBA_Object</span>        bonobo_activation_activate_from_id  (<em class="parameter"><code>const <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> aid</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> *ret_aid</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);</pre>
<p>
Activates the server corresponding to <em class="parameter"><code>aid</code></em>. <em class="parameter"><code>ret_aid</code></em> can be safely 
NULLed as well as <em class="parameter"><code>ev</code></em>. <em class="parameter"><code>flags</code></em> can be zero if you do not know what 
to do.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>aid</code></em> :</span></p></td>
<td>AID or IID of the object to activate.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td>activation flag.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ret_aid</code></em> :</span></p></td>
<td>AID of the activated server.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
<td>
<code class="literal">CORBA_Environment</code> structure which will contain 
     the CORBA exception status of the operation. 
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> a CORBA object reference to the newly activated 
              server. Do not forget to check <em class="parameter"><code>ev</code></em> for failure!!
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="BonoboActivationCallback"></a><h3>BonoboActivationCallback ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                (*BonoboActivationCallback)         (<em class="parameter"><code><span class="type">CORBA_Object</span> activated_object</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *error_reason</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>
This is the signature of the function which you must pass
as a callback to the asynchrounous activation functions.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>activated_object</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error_reason</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-activate-async"></a><h3>bonobo_activation_activate_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_activation_activate_async    (<em class="parameter"><code>const <span class="type">char</span> *requirements</code></em>,
                                                         <em class="parameter"><code><span class="type">char</span> *const *selection_order</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#BonoboActivationCallback" title="BonoboActivationCallback ()"><span class="type">BonoboActivationCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);</pre>
<p>
This function will asynchronously try to activate a component
given the <em class="parameter"><code>requirements</code></em> query string. When the component is
activated or when the activation fails, it will call <em class="parameter"><code>callback</code></em>
with the given <em class="parameter"><code>user_data</code></em> data as parameter.
callback will be called with a CORBA_OBJECT_NIL object if the
activation fails. If the activation fails, the callback will be
given a human-readable string containing a description of the
error. In case of sucess, the error string value is undefined.
</p>
<p>
<em class="parameter"><code>selection_order</code></em> can be safely NULLed as well as <em class="parameter"><code>ev</code></em> and
<em class="parameter"><code>user_data</code></em>. <em class="parameter"><code>flags</code></em> can be set to 0 if you do not know what to
use.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>requirements</code></em> :</span></p></td>
<td>the bonobo-activation query string.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>selection_order</code></em> :</span></p></td>
<td>preference array.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td>activation flags.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>callback function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>data to be poassed to the callback function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
<td>exception structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-activate-from-id-async"></a><h3>bonobo_activation_activate_from_id_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_activation_activate_from_id_async
                                                        (<em class="parameter"><code>const <a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationID" title="Bonobo_ActivationID"><span class="type">Bonobo_ActivationID</span></a> aid</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#Bonobo-ActivationFlags" title="Bonobo_ActivationFlags"><span class="type">Bonobo_ActivationFlags</span></a> flags</code></em>,
                                                         <em class="parameter"><code><a class="link" href="bonobo-activation-Query-and-Activation.html#BonoboActivationCallback" title="BonoboActivationCallback ()"><span class="type">BonoboActivationCallback</span></a> callback</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
                                                         <em class="parameter"><code><span class="type">CORBA_Environment</span> *ev</code></em>);</pre>
<p>
This function will asynchronously try to activate a component
with the given <em class="parameter"><code>aid</code></em>. When the component is
activated or when the activation fails, it will call <em class="parameter"><code>callback</code></em>
with the given <em class="parameter"><code>user_data</code></em> data as parameter.
callback will be called with a CORBA_OBJECT_NIL object if the
activation fails. If the activation fails, the callback will be
given a human-readable string containing a description of the
error. In case of sucess, the error string value is undefined.
</p>
<p>
<em class="parameter"><code>flags</code></em> can be 0 if you do not know what to set it to and
<em class="parameter"><code>ev</code></em> can be safely set to NULL.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>aid</code></em> :</span></p></td>
<td>the AID or IID of the component to activate.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td>activation flags.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>callback function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>data to be poassed to the callback function.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ev</code></em> :</span></p></td>
<td>exception structure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="bonobo-activation-set-activation-env-value"></a><h3>bonobo_activation_set_activation_env_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                bonobo_activation_set_activation_env_value
                                                        (<em class="parameter"><code>const <span class="type">char</span> *name</code></em>,
                                                         <em class="parameter"><code>const <span class="type">char</span> *value</code></em>);</pre>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
<td>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
<td>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.15.1</div>
</body>
</html>